• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch get-list-optimisation

Reviewing files that changed from the base of the PR and between 4fb8d28 and e1b8a8a.

• src/server.ts (1 hunks)
• src/tools/filesystem.ts (3 hunks)

src/server.ts (1)

333-339: Clear and accurate documentation.

The CONTEXT OVERFLOW PROTECTION documentation accurately reflects the implementation in src/tools/filesystem.ts. The warning format example matches the actual output format, and the distinction between top-level (unlimited) and nested directories (100 item cap) is clearly explained.

src/tools/filesystem.ts (8)

897-898: Reasonable constant definition.

The MAX_NESTED_ITEMS = 100 limit is well-chosen for context management. The constant is appropriately scoped within the function.

---

899-899: Well-designed parameter addition.

The isTopLevel parameter with a default value of true maintains backward compatibility while enabling the new filtering behavior. The parameter name is clear and self-documenting.

---

912-921: Correct filtering logic.

The filtering implementation properly distinguishes between top-level (unlimited) and nested directories (capped at 100 items). The logic correctly:

• Applies filtering only to nested directories with more than 100 items
• Calculates the hidden count accurately
• Defaults to showing all entries when filtering isn't needed

---

922-922: Essential loop modification.

Correctly changed the iteration from entries to entriesToShow to apply the filtering. This ensures that only the capped number of items are processed and added to results.

---

934-934: Correct recursive call update.

Passing isTopLevel = false ensures that all subdirectories are treated as nested and subject to the 100-item cap. This correctly implements the cascading filter behavior.

---

943-947: Clear and informative warning message.

The warning is appropriately placed after processing the filtered entries and provides helpful information:

• Shows the exact number of hidden items
• Indicates the total item count
• Matches the format documented in src/server.ts

The conditional ensures warnings are only shown when items are actually filtered.

---

950-950: Explicit top-level designation.

Passing isTopLevel = true explicitly in the initial call improves code clarity, even though the default value would achieve the same result. This makes the intent clear and aids maintainability.

---

897-950: No test updates required

Existing tests only verify the presence of specific entries (e.g., using entries.some(…)) and do not assert on complete directory lengths, so capping nested listings at 100 items won’t break any current assertions.